Collision2MIDI

本插件由两部分组成：一个 MIDI Recorder 对象（兼具场景碰撞检测器、MIDI 录制器和 MIDI 导出器的功能），以及一个 MIDI 标签（MIDI Tag）。

MIDI Tag 可以添加到任何网格对象上，包括 Cloner 和 Voronoi Fracture 对象。只有当被添加标签的对象上已经带有 Simulation 或 Bullet 标签时，该标签才会生效。

标签属性：

Enabled - 启用/禁用该标签。
Note - 在此选择要录制的 MIDI 音符，范围从 C-1 到 G9，对应 127 键的键盘。默认为 C4（音符 60）。界面中有一张辅助图片，用于显示该音符在键盘上的八度和琴键位置；信息文本中会显示音符名称及对应的 MIDI 音符编号。

如果添加标签的对象是 Cloner，则有两种 Clone Recording Mode 可供选择：

1. Single Object - 所有实例的碰撞都将以同一个音符录制。

2. By Child - 每个子对象都将以不同的音符录制，从所设定的 Note 开始依次升高。

Duration - 定义音符的时值。
Duration Variance - 定义所设音符在时值上的变化幅度。
Pitch Variation - 定义检测到碰撞时的音高变化系数，以相对于所设音符的半音数来表示。
Use Pitch Modulation - 将 Pitch Variation 以对所设音符的音高调制形式录制。
Seed - 对用于生成变化的随机算法进行微调。
Touch Note - 定义对持续碰撞（接触）的检测。
Record in Different Note - 检测到 Touch 时，将其录制为另一个音符。
Cool Down Recording - 定义从上一次检测到碰撞起算的时长过滤，可用于过滤过于频繁的快速碰撞或碰撞检测精度误差。

Impact Threshold - 定义录制音符音量所需的速度阈值。
Velocity from Impact - 启用后，对象的速度会影响音符的音量。
Impact Min / Impact Max - 定义可参与音量录制所需的最小和最大速度。

MIDI Channel - 定义音符录制所在的 MIDI 通道。
Program (GM Instrument) - 定义演奏该音符所用的 MIDI 乐器。

MIDI Recorder 属性：

Source Objects - 将被录制（即被追踪碰撞）的已添加标签对象列表。

Ambient Sound Volume - 启用后，将根据对象与摄像机的距离录制音量。
Camera - 可以是任何类型的摄像机（包括 Stage 对象），用于定义“收听”对象声音的当前摄像机，并据此计算距离，以得到正确的音量。
Maximum Volume / Minimum Volume - 定义从摄像机位置录制时，音符所允许的最大和最小音量。
Minimum Distance / Maximum Distance - 定义与 Camera 对象之间的最小和最大距离，碰撞音量将在此范围内映射到 Min Volume 和 Max Volume 之间。
Sound Dampening Model - 定义根据对象与 Camera 的距离计算音量时所使用的衰减模型。

Doppler - 启用后，将根据对象相对于 Camera 的运动，为录制的音符加入音高变化（多普勒效应）。

Track Layout - 定义音符在 MIDI 文件中的导出方式：

1. Single Track - 所有对象都录制在同一个音轨和文件中。

2. Per Source - 每个对象分别录制到各自的 MIDI 文件中。

3. MPE - 所有对象分层录制在同一个文件中。部分 DAW 不支持 MPE。

Contact Detection - 定义判定碰撞的机制。Impact Only 速度更快。

Time Line Range - 定义录制声音的时间范围。

Export Directory - 导出文件夹路径。
Export Name - MIDI 文件的名称。当 Track Layout 为 Per Source 时，每个文件名都会以对象名称作为后缀；如果多个对象同名，则使用其 ID。
Export CSV - 用于 AE（After Effects）。
Export MIDI - 将时间线烘焙（bake）为 MIDI 文件。